2.2 配置 GLM

GLM（智谱AI）是国内领先的大语言模型之一，由智谱AI开发，对中文理解能力出色，支持多种应用场景。以下是配置 GLM 到 Claude Code 的详细步骤。（https://docs.bigmodel.cn/cn/coding-plan/tool/claude）

注册与获取 API#

步骤 1：注册智谱AI账户#

访问智谱AI开放平台：https://bigmodel.cn/
点击页面左上方的"注册"按钮
输入手机号并进行验证，完成注册
完成实名认证（实名认证后可获得更多免费额度）

步骤 2：获取免费额度#

注册后自动获得 100 万 tokens 免费额度
完成实名认证后额外获得 400 万 tokens（有效期一个月）
新用户总共可获得 500 万 tokens 的免费额度

GLM 推出了编码套餐，你可以点击这里订购编码套餐，配合Claude Code，完成你的工作需求。

步骤 3：获取 API Key#

登录智谱AI开放平台
点击右上角的"查看API Key"或进入"API管理"
点击"添加新的Key"或"创建新Key"
填写Key名称（可选），点击确认
系统会生成 API Key
重要：妥善保存 API Key，建议复制到安全的地方

配置 Claude Code#

配置 GLM 到 Claude Code 有三种方式，选择适合你的一种即可。

方式一：使用自动化助手（推荐）#

Coding Tool Helper 是一个编码工具助手，可以快速将 GLM 编码套餐加载到 Claude Code 中。

步骤 1：运行自动化助手

在终端中执行以下命令：


bash
npx @z_ai/coding-helper

步骤 2：按照提示操作

自动化助手会引导你完成：

工具安装
套餐配置
MCP 服务器管理

这是最简单快捷的方式，适合大多数用户。

方式二：使用自动化脚本（仅限 macOS 和 Linux）#

如果你使用 macOS 或 Linux 系统，可以使用自动化脚本快速配置。

步骤 1：下载并运行脚本

在终端中执行以下命令：


bash
curl -O "https://cdn.bigmodel.cn/install/claude_code_env.sh" && bash ./claude_code_env.sh

步骤 2：脚本自动配置

脚本会自动修改 ~/.claude/settings.json 文件，配置以下环境变量：


json
{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "your_zhipu_api_key",
        "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
        "API_TIMEOUT_MS": "3000000",
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
    }
}

注意：请将 your_zhipu_api_key 替换为你实际获取的 API Key。

方式三：手动配置#

如果你需要手动配置，请根据你的操作系统选择以下方式之一。

macOS 和 Linux

创建或编辑配置文件 ~/.claude/settings.json
添加以下内容（替换 your_zhipu_api_key 为你的 API Key）：


json
{
    "env": {
        "ANTHROPIC_AUTH_TOKEN": "your_zhipu_api_key",
        "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
        "API_TIMEOUT_MS": "3000000",
        "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
    }
}

Windows（Cmd）

在 Cmd 中运行以下命令（替换 your_zhipu_api_key 为你的 API Key）：


cmd
setx ANTHROPIC_AUTH_TOKEN your_zhipu_api_key
setx ANTHROPIC_BASE_URL https://open.bigmodel.cn/api/anthropic
setx CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 1

Windows（PowerShell）

在 PowerShell 中运行以下命令（替换 your_zhipu_api_key 为你的 API Key）：


powershell
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_AUTH_TOKEN', 'your_zhipu_api_key', 'User')
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://open.bigmodel.cn/api/anthropic', 'User')
[System.Environment]::SetEnvironmentVariable('CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC', '1', 'User')

重要提示：配置完成后，请关闭所有终端窗口，打开一个新的终端窗口以使配置生效。

测试连接#

步骤 1：启动 Claude Code#

配置完成后，在终端中进入你的代码工作目录，执行以下命令启动 Claude Code：


bash
claude

步骤 2：信任文件夹#

首次启动时，Claude Code 会询问是否信任当前文件夹，选择 Yes。

步骤 3：发送测试消息#

在 Claude Code 的聊天界面中，输入一条简单的测试消息，例如：


bash
你好，请用一句话介绍一下你自己。

步骤 4：验证结果#

如果看到 GLM 的回复，说明配置成功！

回复应该流畅自然
响应时间应该在几秒内
没有错误提示

步骤 5：检查模型状态（可选）#

在 Claude Code 中输入 /status 命令，可以查看当前使用的模型状态和配置信息。

GLM 模型介绍#

GLM Coding Plan 默认使用智谱 AI 的最新模型，通过环境变量映射到 Claude Code 的模型层级。

默认模型映射#

配置成功后，GLM 模型会自动映射到 Claude Code 的模型层级：

Claude Opus → GLM-4.7（最强大的模型）
Claude Sonnet → GLM-4.7（平衡性能与速度）
Claude Haiku → GLM-4.5-Air（快速响应模型）

提示：默认情况下，你在 Claude Code 界面上看到的是 Claude 模型名称，但实际使用的是 GLM 模型。这是服务端的模型映射，无需手动配置。

GLM-4.7#

特点：智谱最新的旗舰模型，综合能力最强
适用场景：复杂任务、深度代码生成、需要高质量输出的场景
性能：在代码生成、逻辑推理、问题解决等方面表现优异

GLM-4.5-Air#

特点：轻量级模型，响应速度快
适用场景：快速对话、简单任务、需要实时响应的场景
性能：响应速度快，适合大量使用

手动切换模型（高级用户）#

如果你需要手动切换模型，可以编辑 ~/.claude/settings.json 文件，添加以下配置：


json
{
  "env": {
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.7",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.7"
  }
}

注意：一般不建议手动调整模型映射，因为硬编码后当 GLM Coding Plan 的模型更新升级时，不方便自动更新到最新模型。

常见问题#

Q：API Key 泄露了怎么办？ A：立即在智谱AI开放平台删除旧密钥，创建新的密钥，并更新你的配置。

Q：配置后提示"认证失败"怎么办？ A：检查以下几点：

API Key 是否正确，注意不要有多余的空格
Base URL 是否填写为 https://open.bigmodel.cn/api/anthropic
配置后是否重新打开了新的终端窗口
配置文件的 JSON 格式是否正确

Q：免费额度用完了怎么办？ A：可以在智谱AI开放平台购买付费套餐，价格比较实惠。GLM Coding Plan 还提供以更低价格获得 3 倍用量的套餐。

Q：如何确认配置是否生效？ A：启动 Claude Code 后，输入 /status 命令查看模型状态和配置信息。

Q：配置后没有生效怎么办？ A：尝试以下排查步骤：

关闭所有 Claude Code 窗口
重新打开一个新的命令行窗口
再次运行 claude 启动
如果问题仍然存在，可以删除 ~/.claude/settings.json 文件，然后重新配置
确认配置文件的 JSON 格式是否正确，可以使用在线 JSON 校验工具进行检查

Q：GLM 的中文能力如何？ A：GLM 是国内领先的大模型之一，中文理解能力非常出色，适合中文用户使用。

Q：可以在多个项目中使用同一个 API Key 吗？ A：可以，一个 API Key 可以在多个项目中使用，但建议为不同项目创建不同的 Key 以便于管理。

Q：推荐使用哪个版本的 Claude Code？ A：建议使用最新版本的 Claude Code。你可以通过以下命令检查当前版本和升级：


bash
# 检查当前版本
claude --version

# 升级到最新版本
claude update

我们在 Claude Code 2.0.14 等版本验证通过，建议使用此版本或更新版本。

Q：如何切换使用不同的 GLM 模型？ A：默认情况下，GLM 模型会自动映射到 Claude Code 的模型层级。如果需要手动切换，可以编辑 ~/.claude/settings.json 文件，修改 ANTHROPIC_DEFAULT_HAIKU_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL 环境变量。但一般不建议手动调整，以便自动更新到最新模型。

Q：配置文件修改后不生效怎么办？ A：确保：

JSON 格式正确，检查变量名称、逗号等
关闭所有 Claude Code 窗口，重新打开新的终端
如果问题持续，可以删除配置文件重新配置

Claude Code 深度教程